home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_497 / newshellcx / newshellcx.doc < prev    next >
Text File  |  1992-05-06  |  8KB  |  206 lines
  1.  
  2.                               NewShellCX
  3.  
  4.                              (Commodity)
  5.  
  6.                                   by
  7.  
  8.                             Stefan Sticht
  9.  
  10.          This program (binary), sourcecode, documentation is 
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.                      You may do anything with it!
  15.  
  16.  
  17. Purpose of this commodity:
  18. --------------------------
  19. NewShellCX  allows  you to open a new shell by just pressing a hotkey.
  20. The hotkey and the command, which will be executed can be specified.
  21.  
  22. Requirements:
  23. -------------
  24. This commodity requires at least Kickstart 37.#?  and Workbench 37.#?.
  25. Please  check  this  out  using Version in the Shell or About from the
  26. Workbench's   Workbench   menu.    You   also   need   to   have   the
  27. commodities.library  in your libs:  directory.  Please check this out:
  28. type "dir libs:" in the shell.
  29.  
  30.  
  31. How to start a commodity:
  32. -------------------------
  33. First  there  are  two  basically different ways to start a commodity:
  34. via Workbench or via Shell.
  35.  
  36.     Starting  it  via Workbench is extrem simple:  just doubleclick on
  37. its  icon  and  the  commodity gets started.  Perhaps you might change
  38. some  parameters of the commodity.  You do this with tool types.  Tool
  39. types can be changed by clicking at the commodities icon and selecting
  40. Information from the Workbench's Icon menu.  In the window which opens
  41. you  see a listview gadget in which all tool types are listed.  Please
  42. refer  to  your  Workbench  documentation  on  how to change this tool
  43. types.  Which parameters you can change for this specific commodity is
  44. described below.
  45.     Please  note  that  another  double  click on the commodity's icon
  46. forces  the  commodity  to quit, if it's already running.  Running two
  47. copies  of  NewShellCX  at  the  same  time isn't useful and therefore
  48. possible.
  49.     To  start  a commodity via shell you type in its name.  If you get
  50. an  "Unknown  command  ???"  error  message,  you  have misspelled the
  51. commodity's  name  or the commodity isn't in your current directory or
  52. in the current search path.  The easiest way is to change your current
  53. directory  to the location of the commodity using the CD command.  You
  54. can  change  parameters  of  a commodity by command line options.  The
  55. available options are listed with ?  as the first parameter:
  56.  
  57.                              NewShellCX ?
  58.  
  59. gives you a list of the command line options.  The explanation of each
  60. option is below.  Starting the commodity once more while it is already
  61. running forces the commodity to quit.
  62.  
  63.     If  you  want  the  commodity to be started at every boot-up, it's
  64. best to add this line to your User-Startup file:
  65.  
  66.                  Run >NIL: <path>NewShellCX <options>
  67.  
  68. Don't  forget  to  replace  <path>  by  the  path to the commodities's
  69. location  and <options> by the options you want to change. For example
  70. add this line if your commodity is located in the Tools drawer of your
  71. boot disk:
  72.  
  73.                       Run >NIL: Tools/NewShellCX
  74.  
  75.     Another way to start the commodity at every boot-up is to drag its
  76. icon  in  the  WBStartup drawer of your boot disk.  Then the commodity
  77. gets  started  as if you had double clicked on its icon.  But you have
  78. to  add the tool type DONOTWAIT to the icon.
  79.  
  80. This is the common way to start any commodity.  Starting NewShellCX to
  81. spawn  a  new  shell is bit more complicated.  If you start NewShellCX
  82. from Workbench (or from the WBStartup-drawer), a opened shell will not
  83. inherit   the   path   specified   in   the   startup-sequence  and/or
  84. User-Startup.   If  you  do  not  want  to  update  your  path  in the
  85. Shell-Startup  file  using an explicit Path command, the only solution
  86. is  to  start  NewShellCX  in your User-Startup file after setting the
  87. path.   If  do  not change the path in your User-Startup file, you may
  88. start NewShellCX anywhere in User-Startup.
  89.  
  90. Using Exchange:
  91. ---------------
  92. Exchange is the commodities controller program. With Exchange you can
  93. control all commodities: you can kill, disable, enable, show and hide
  94. commodities.
  95.     Start  the  Exchange  program,  which  usually is in the Utilities
  96. drawer  of your boot disk, by double clicking its icon.  Now you see a
  97. list  of  the available commodities.  Select the commodity you want to
  98. control.   The  commodities title, description and status is shown now
  99. below the listview gadget.
  100.     You  can  kill  the  commodity  using  the  Kill gadget...  If the
  101. commodity  has  a  window  to  open,  in which you usually change some
  102. parameters,  you  can  open  this window using Show.  Hide closes this
  103. window. NewShellCX has no window, which can be opened.
  104.  
  105.                         Changeable parameters:
  106.                         ----------------------
  107.  
  108. CX_Priority:
  109. ------------
  110. You  can  specify the priority of the Commodity within the commodities
  111. queue using the tool type or commandline option CX_PRIORITY=<n>, where
  112. <n> is the decimal value for the priority.  Default priority is 0.
  113.  
  114. HOTKEY:
  115. -------
  116. With  the  tool  type or commandline option HOTKEY=<input> you specify
  117. the  key, which executes the command.  <input> is an input description
  118. string  as  explained  below.   Default is "HOTKEY=lcommand esc" (left
  119. Amiga key & ESC key).
  120.  
  121. Examples:
  122.  
  123.     NewShellCX "hotkey=ralt help"
  124.     NewShellCX "hotkey=lcommand m"
  125.     NewShellCX "hotkey=f1"
  126.  
  127. COMMAND:
  128. --------
  129. With  the  tool  type or commandline option COMMAND=<file> you specify
  130. the  command,  which  you want to be executed.  <file> is the path and
  131. name  of the command plus additional parameters, just as if you'd type
  132. this  line at a shell.  Default is COMMAND=NewShell, which spans a new
  133. shell.
  134.  
  135. Examples:
  136. NewShellCX "Command=NewShell CON:0/0/640/200/MyShell/CLOSE FROM s:Shell-Startup"
  137. NewShellCX "Command=c:NewWSH"
  138. NewShellCX "Command=Tools:ClickDOS_II"
  139.  
  140.  
  141.  
  142.                       Input description strings
  143.                       -------------------------
  144.  
  145. With  input  description  strings  you  can  specify  almost any input
  146. action,  for  example  the action lshift f1, which means that pressing
  147. the  left  shift  and  the  f1  key  together  is the action.  In this
  148. commodity  you  can specify the action to open the commodity's window,
  149. as described above.
  150.  
  151. Input description strings have the following template:
  152.  
  153.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  154.  
  155. (* means zero or more occurances of the of the expression in brackets)
  156.  
  157. class   is one of the following strings:
  158.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  159.         diskremoved, diskinserted.
  160.         If not specified, the class is taken to be "rawkey".
  161.  
  162. qual    is one of the strings:
  163.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  164.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  165.         relativemouse
  166.         A preceding '-' means that the value of the corresponding
  167.         qualifier is to be considered irrelevant.
  168.  
  169. syn     (synonym) is one of the strings: shift, caps, alt
  170.         shift means "left or right shift"
  171.         caps means "shift or capslock"
  172.         alt means "either alt key"
  173.  
  174. upstroke (literally "upstroke")
  175.         if this token is absent, only downstrokes are considered
  176.         for rawmouse (mousebuttons) and rawkey events.  If it is
  177.         present alone, only upstrokes count.  If it preceded by
  178.         '-' it means that both up and down strokes are included.
  179.  
  180. highmap one of the strings:
  181.         comma, space, backspace, tab, enter, return, esc, del, up, down,
  182.         right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10,
  183.         0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  184.  
  185. ansicode a single character token is interpreted as a character code,
  186.         which is looked up in the system default keymap.
  187.  
  188.  
  189.  
  190.  
  191. Send bug-reports, enhancement-requests, questions, gifts(!) to:
  192. ---------------------------------------------------------------
  193. Stefan Sticht
  194. Bibereckerweg 40a
  195. D-8390 Passau 18
  196. FRG
  197.  
  198. or (better) EMail to:
  199. Internet: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht@rutgers.EDU
  200.       or: IWSTICHT@ibm.rz.uni-passau.de
  201. Fido-Net: Stefan Sticht (2:242/16)
  202.  
  203. Please include the version number of the commodity in every bug report.
  204. You  get  the  version  number  using  the  Version  command:
  205.                      Version [<path>]<commodity>
  206.